home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / bbscomp4.zip / README4 < prev   
Text File  |  1991-12-27  |  5KB  |  108 lines
  1. LEGALITIES
  2.  
  3.     This product is not FREE, it is being distributed as Shareware.
  4.     This means you are granted a limited license to evaluate this
  5.     product.  If, after a 30 day trial period, you are still using
  6.     this program, you are required to register it.  Registered users
  7.     will be advised of upgrades and changes in documentation.
  8.  
  9.     This program does constitute numerous hours of developement on my
  10.     part.  I certainly don't think I'll get rich via distributing this
  11.     program, but I would appreciate a small registration fee if you
  12.     find this program of value.  Registration fees and suggestions for
  13.     enhancements are gratefully accepted.  I don't think that a $5 fee
  14.     is unreasonable, do you?  I can be reached via E-mail on Exec-PC,
  15.     Milwaukee, which I might add, in my personal "un-biased" opinion,
  16.     is THE best BBS in the country!  (414) 789-4210.  Thanks!
  17.  
  18.     I claim no responsibilities for any damage incurred as a result of
  19.     using this program.  I reserve all rights to this program.
  20.  
  21.     (c) 1989,1990 Gary L. Vandenberg
  22.                   977 S. 56th St.
  23.                   Milwaukee, WI 53214
  24.  
  25. RELEASE 4!
  26.  
  27.     Yes, folks, I made it!  The response to Versions 1 & 2 was so 
  28.     overwhelming, and release 3 never made it to the boards, Release 4 
  29.     is now available!  It now prompts you for sorting prior to 
  30.     performing the compare that gives the Up and Down load 
  31.     opportunities.  This should eliminate the step of externally 
  32.     sorting your files prior to running the program.  I'm now using an 
  33.     superb sorting algorythm so you should see some performance 
  34.     improvement there (my tests sorted a 6000 line file in about 8 
  35.     seconds).  The input file size limit is 10,000 records, I'm still
  36.     struggling with how to increase this.  For the time being, if your 
  37.     file is larger than this, there are plenty of sort utilities that 
  38.     can pre-sort your file before running BBSCOMP.  Enjoy!
  39.  
  40.  
  41. OVERVIEW
  42.  
  43.     This program is intended to assist the more-avid BBS'er.  It reads
  44.     in the your file list and the BBS's file list, and then produces
  45.     three output files.  The first file, UL.DAT, shows files that you
  46.     have and the BBS doesn't, showing your opportunities for uploading.
  47.     The second file, DL.DAT, shows files that the BBS has that you
  48.     don't, showing your download opportunities.  The third file,
  49.     COMMON.DAT, is intended as somewhat of an audit trail and shows the
  50.     files that you have in common with the BBS.
  51.  
  52.     While I don't run a BBS, I can certainly sympathize both with
  53.     SYSOP's trying to get users to upload, and also with users that
  54.     just want to "get those new files and try 'em out".  This program
  55.     should help users more easily comply with upload/download ratios,
  56.     etc., by showing the exact files that are suitable in either
  57.     direction.
  58.  
  59.  
  60. OPERATION
  61.  
  62.     This program was originally written in QuickBasic 4.5 (Nice
  63.     Language!).  It is now in Basic PDS 7.1.  Many BBS's seem to have
  64.     standardized on the file directory display format show below:
  65.  
  66.  
  67. JACKSON1.GIF    49152  02-08-89  Le Toya Jackson VGA Gif #2 in Series of 5
  68. JACKSON3.GIF    19456  02-08-89  Le Toya Jackson VGA Gif. #2 in series of 5
  69. JACKSON4.GIF    26624  02-08-89  Le Toya Jackson VGA Gif #4 in series of 5
  70.  
  71.     Given this format, it seemed simple enough to compare this list
  72.     type to my own computer's directory listing.
  73.  
  74.     STEP 1
  75.     First, you need to create an input listing of your files that you
  76.     want to compare to the BBSs'.  This can be obtained by by using
  77.     the command:
  78.  
  79.         DIR >FILENAME
  80.  
  81.     Or if you have a disk(ette) cataloging program that stores the
  82.     filename in ASCII, in positions 1 thru 12 or can export such a
  83.     report, that will do fine also.
  84.  
  85.     STEP 2
  86.     The second step in using this program, is to capture or download a
  87.     BBS file listing that you are interested in.  It again assumes the
  88.     above format, that is, at least the file name is expected to start
  89.     in column 1 and be no longer than 12 characters.
  90.  
  91.     STEP 3
  92.     Simple enough, start the enclosed program called BBSCOMP4.  You
  93.     will be prompted for YOUR directory file name and the BBS
  94.     directory file name.  You will then have the option of sorting the
  95.     input files first.  After the sort is complete, or you have
  96.     answered "no", the compare will start executing.  The output of
  97.     the program will be stored in the current sub-directory as UL.DAT,
  98.     DL.DAT, and COMMON.DAT.
  99.  
  100.  
  101. NOTES
  102.  
  103.     File extensions are dropped during the compare since a program may
  104.     exist on your system in an excutable form (.EXE) and is most
  105.     likely in a compressed form on the BBS (.ZIP).  Any records that
  106.     start with a space or period are dropped, this helps filter your
  107.     listing if you attain it via the DIR >FILENAME sequence.
  108.